home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / sdn / rboot5.sdn / REBOOT.DOC < prev    next >
Text File  |  1991-08-01  |  43KB  |  879 lines

  1.  
  2.  
  3.  
  4.        REBOOT v5.00 User Manual                                Page  -1-
  5.  
  6.  
  7.                                                          1st August 1991
  8.  
  9.                                  REBOOT v5.00
  10.  
  11.                      (C) Copyright 1990, 1991, Peter Ogden
  12.  
  13.  
  14.  
  15.  
  16.                                    CONTENTS
  17.                                    --------
  18.  
  19.  
  20.        Caution.........................................................2
  21.        Limit of liability..............................................2
  22.        Purpose.........................................................2
  23.        License information.............................................3
  24.        Files included in the REBOOT suite..............................4
  25.        Compatibility...................................................4
  26.        Setting up......................................................4
  27.        Installing user options in REBOOT...............................7
  28.        Running REBOOT..................................................8
  29.        Sequence of events..............................................9
  30.        Companion programs.............................................10
  31.           ACTIVE......................................................10
  32.           BTIME.......................................................11
  33.           CHKBOOT.....................................................11
  34.        Trouble-shooting...............................................12
  35.           REBOOT.CFG corruption.......................................12
  36.           Erratic mouse flashing......................................12
  37.           Insufficent memory for editor...............................12
  38.           Error - unable to load editor...............................12
  39.           Error - unable to create temporary file.....................13
  40.           Error - unable to create REBOOT.TMP.........................13
  41.           Error - unable to open REBOOT.CFG...........................13
  42.           Error - null #Name encountered..............................13
  43.        Program history................................................14
  44.        About REBOOT...................................................16
  45.        Acknowledgements...............................................17
  46.  
  47.  
  48.  
  49.  
  50.        REBOOT v5.00 User Manual                                Page  -2-
  51.  
  52.  
  53.        **************************** CAUTION ****************************
  54.  
  55.        Users  of Delayed  Write disk  caches should  read this  document
  56.        thoroughly before using REBOOT. If REBOOT is not set up correctly
  57.        there  is a  slight possibility  of damage  to data  on your hard
  58.        disk.
  59.  
  60.        *****************************************************************
  61.  
  62.  
  63.                               LIMIT OF LIABILITY
  64.  
  65.        REBOOT is distributed as-is. The author disclaims all warranties,
  66.        expressed  or implied.  The author  will assume  no liability for
  67.        damages  either from  the direct  use  of  this product  or as  a
  68.        consequence  of  the  use  of  this product.  Further, the author
  69.        reserves the right to revise this publication and to make changes
  70.        from time to time in the content hereof without obligation of the
  71.        author to notify  any person or organisation of  such revision or
  72.        changes.
  73.  
  74.  
  75.                                     PURPOSE
  76.  
  77.        As application programs become larger and more complex, conflicts
  78.        between  programs  become  more and  more  common.  Some programs
  79.        simply  require  a  larger  amount  of  memory  than  is normally
  80.        available.  The simple solution  is to reboot the computer with a
  81.        different (non conflicting, or low memory use) configuration.
  82.  
  83.        The REBOOT  suite of programs  have been written  to perform this
  84.        task, and to  preserve the users environment as  much as possible
  85.        across these reboots, and with special handling for 4DOS.
  86.  
  87.        REBOOT  can  reboot  the  computer  with  a  new  CONFIG.SYS  and
  88.        AUTOEXEC.BAT  selected from  a list  of choices  (maximum of  128
  89.        configurations allowed). Delayed write (also called staged write)
  90.        disk caches are catered for. For users of 4DOS 3.0 and above, the
  91.        command history list can be written  to a file before booting (if
  92.        you  don't use  4DOS currently,  you should try it).  The various
  93.        configurations are kept in a single file (REBOOT.CFG).
  94.  
  95.        Note: 4DOS is a shareware  replacement (by J.P. Software) for the
  96.              MS/PC-DOS COMMAND.COM.  It enhances the  existing commands,
  97.              adds several new commands,  scrollable command history, and
  98.              heaps more.  If you work  with DOS at  the command line  or
  99.              write complex batch files, you should be using it!  4DOS is
  100.              available on good BBS's all over the world.
  101.  
  102.  
  103.  
  104.  
  105.        REBOOT v5.00 User Manual                                Page  -3-
  106.  
  107.  
  108.                               LICENSE INFORMATION
  109.  
  110.        REBOOT  is  the  copyrighted  property  of  Peter Ogden.  You are
  111.        granted a limited license to use, copy, and distribute the REBOOT
  112.        suite of programs provided the following conditions are met:
  113.  
  114.           A. Copying  and  distribution  fees   may  not  exceed  $15.00
  115.              Australian.
  116.  
  117.           B. REBOOT may  only be distributed in  its original unmodified
  118.              state.
  119.  
  120.        This software  is distributed under  the user supported  software
  121.        concept. Though REBOOT is copyrighted, you are encouraged to copy
  122.        and distribute this program to others.  If you  like this product
  123.        and find  it useful, a  registration fee of  $20.00 Australian is
  124.        required for continued use. A twelve month instant update plan is
  125.        available  (new  versions  mailed  to  you  as  soon  as they are
  126.        complete)  for  an  additional  $25.00  AUS.  Site  licenses  are
  127.        available at a reduced rate (contact the author).
  128.  
  129.        The user  supported software concept (also  known as "shareware")
  130.        is an attempt  to provide quality software at low cost.  Both the
  131.        user and author benefit from this plan.  The user will benefit by
  132.        being able to "test  drive" software thoroughly before purchasing
  133.        it.  The author  benefits by  being able  to enter the commercial
  134.        software  market  while  avoiding  the  high  cost  of commercial
  135.        distribution.
  136.  
  137.        This concept  helps many independent authors  and small companies
  138.        that would otherwise be discouraged from developing and promoting
  139.        their ideas.  It can only work with your support. If you obtain a
  140.        user supported program  from a friend and you  are still using it
  141.        after a few  weeks, then it is obviously  worth something to you,
  142.        and a contribution should be sent.
  143.  
  144.        For   further   information   and   registration,   please   send
  145.        correspondence to:
  146.  
  147.                Peter Ogden
  148.                ESB Consultancy
  149.                P.O. Box 2259,
  150.                Boulder,
  151.                Western Australia      6432
  152.  
  153.            or  Fax: +61 90 21 8364
  154.  
  155.        or,   for   information,   bug   reports,   or  suggestions  (not
  156.        registration) Netmail at 3:690/643.5 (FidoNet).
  157.  
  158.  
  159.  
  160.  
  161.        REBOOT v5.00 User Manual                                Page  -4-
  162.  
  163.  
  164.                       FILES INCLUDED IN THE REBOOT SUITE
  165.  
  166.        ACTIVE.EXE        Program  that  reports   the  active  (current)
  167.                          configuration.
  168.        BTIME.EXE         Program that adds or updates the Date/Time line
  169.                          in  REBOOT.CFG.  In  combination  with CHKBOOT,
  170.                          allows    conditional    processing    in   the
  171.                          AUTOEXEC.BAT (see also CHKBOOT.EXE).
  172.        CHKBOOT.EXE       Program  that  reads  the  Date/Time  line from
  173.                          REBOOT.CFG,  compares it  to the  current Date,
  174.                          and returns  a DOS error  level depending on  a
  175.                          supplied condition.
  176.        EXAMPLE1.CFG      An example config file (simple).
  177.        EXAMPLE2.CFG      An example config file (network).
  178.        EXAMPLE3.CFG      An example config file (complex).
  179.        REBOOT.DOC        This document.
  180.        REBOOT.EXE        The main REBOOT program.
  181.        REGISTER.FRM      Registration form.
  182.  
  183.  
  184.                                  COMPATIBILITY
  185.  
  186.        REBOOT should run  on any IBM PC, PC/XT, AT,  386 or 486 or close
  187.        compatible with  at least 128K  RAM (512K for  editing function),
  188.        single floppy disk drive, monochrome or colour display, MS/PC-DOS
  189.        version 3.0 or later, with or without a mouse.  Screen writes are
  190.        direct to video RAM (or if Desqview present, via a shadow buffer)
  191.        for reasonable  speed of display.  Users of EGA/VGA displays have
  192.        the option of high intensity backgrounds.
  193.  
  194.  
  195.                                   SETTING UP
  196.  
  197.        First, a  file containing all your  different configurations must
  198.        be  created (or  one of  the included  examples modified to suit)
  199.        using a standard ASCII text  editor, either from within REBOOT or
  200.        manually.  The general form of this file is:
  201.  
  202.  
  203.  
  204.  
  205.        REBOOT v5.00 User Manual                                Page  -5-
  206.  
  207.  
  208.        #Name = Config 1
  209.        {                                         }
  210.        {  Lines to be written to the CONFIG.SYS  }
  211.        {                                         }
  212.        ---
  213.        {                                         }
  214.        { Lines to be written to the AUTOEXEC.BAT }
  215.        {                                         }
  216.        #Name = Config 2
  217.        {                                         }
  218.        {                etc...                   }
  219.        {                                         }
  220.  
  221.        The REBOOT.CFG  starts with the name  given to this configuration
  222.        (which MUST  be unique).  It is followed by  the CONFIG.SYS lines
  223.        (as you  would normally have them in DOS's CONFIG.SYS),  followed
  224.        by  a  divider  line  (consisting  of,  at  least, 3 dashes '-'),
  225.        followed by the AUTOEXEC.BAT lines (also exactly as you have them
  226.        in DOS's AUTOEXEC.BAT).
  227.  
  228.        REBOOT.CFG should  be in a directory  that is in the  PATH or you
  229.        will  always  have  to  change  to  that directory before calling
  230.        REBOOT.
  231.  
  232.        Where  possible,  REBOOT  allows  comments  to be included in the
  233.        REBOOT.CFG.  To include  a full  line comment,  the character  in
  234.        column  one of  the line  must  be  a semicolon  (;) (see  sample
  235.        REBOOT.CFG's).  Any comment entered on a #Name command line after
  236.        column  28  is  ignored ('#Name =  '  + 20  character name).  Any
  237.        comments entered  after the divider  (on the same  line) are also
  238.        ignored.  Blank lines  may also  be included  in REBOOT.CFG  (not
  239.        written to the AUTOEXEC.BAT or CONFIG.SYS).
  240.  
  241.        All  commands for  REBOOT begin   with a  '#' symbol  (except the
  242.        active configuration as noted below), must begin in column 1, are
  243.        followed by space, an '=' symbol and another space.
  244.  
  245.              e.g., #Name = QEMM 5.11
  246.  
  247.        The command  may be in any  mixture of upper or  lower case (i.e.
  248.        #NAME = , #Name = , #name = , are all equivalent).
  249.  
  250.        The  current, active  configuration is  marked by  the use  of an
  251.        asterisk  (*)  instead  of  the  hash  symbol  (#)  as  the first
  252.        character of  a REBOOT special command.  All the commands related
  253.        to the active configuration must  begin with an asterisk (*) (see
  254.        example REBOOT.CFG's).
  255.  
  256.  
  257.  
  258.  
  259.        REBOOT v5.00 User Manual                                Page  -6-
  260.  
  261.  
  262.        REBOOT currently has eight special commands:
  263.  
  264.        #Name   This is the  only command that must be  in the REBOOT.CFG
  265.                file. This indicates the beginning of a configuration and
  266.                the  name to  use in  the pop  up pick list.  The maximum
  267.                length of the name is 20 characters (any characters after
  268.                this are ignored).  Any characters may be used  in a name
  269.                except the  slash (/) character (which  could be confused
  270.                with a command line option).
  271.  
  272.        #Descr  (Optional).  Allows a single line description to be given
  273.                for each  configuration (maximum of  80 characters). This
  274.                line  is displayed  at the  bottom of  the screen  as you
  275.                scroll through the pick list. The first 40 characters are
  276.                written to the 4DOS DESCRIPT.ION file if it exists.
  277.  
  278.        #Flush  (Optional).  This  is the command line you would  type to
  279.                flush the  delayed write (also called  staged write) disk
  280.                cache. If more than a  single line command is required to
  281.                flush the  cache, a batch file  may be named.  If you use
  282.                4DOS, this line can be a compound command (maximum of 255
  283.                characters).
  284.  
  285.                This line actually causes REBOOT  to EXEC another copy of
  286.                the command  processor, so in fact,  you could get REBOOT
  287.                to perform almost any function before booting.
  288.  
  289.        ***************************** NOTE ******************************
  290.  
  291.        If  you  use  a  delayed  write  disk  cache,  you  MUST  include
  292.        the #Flush line  in every configuration that loads  the cache, as
  293.        without  it, the  configuration may  not be  written to  the disk
  294.        completely before the PC is rebooted.  If this occurs, there is a
  295.        chance  that the  file allocation  table (FAT)  could be damaged,
  296.        possibly rendering the data on the  disk unreadable.  See example
  297.        configuration files for examples of how to set up PC-CACHE v6 and
  298.        HYPERDISK.
  299.  
  300.        *****************************************************************
  301.  
  302.        #Hist   (Optional).  This command  line gives  the full  path and
  303.                filename  of  the  command  history  file  to  store  the
  304.                command  history  for  this  configuration.  This  allows
  305.                multiple  (separate)  command  histories  to  be kept for
  306.                unique configurations.  If no #Hist line  is included, no
  307.                attempt is  made to save the command history.  Currently,
  308.                only 4DOS command history is handled.
  309.  
  310.  
  311.  
  312.  
  313.        REBOOT v5.00 User Manual                                Page  -7-
  314.  
  315.  
  316.        #Date   (Optional,  added  by  BTIME)  This  line  is  ignored by
  317.                REBOOT.  The Date  and Time  are added  to REBOOT.CFG  by
  318.                BTIME, and tested by CHKBOOT. ACTIVE also reads this line
  319.                and will display the time and  date of the last boot if a
  320.                valid time and  date are found.  The time and date should
  321.                not be manually entered (format is important).
  322.  
  323.        #Defs,  (Optional,  added by Install option)  These lines contain
  324.        #Defs2  all  the  customisation  information  (colours,  defaults
  325.                etc.) that the user selects with the Install option. This
  326.                line should not be manually edited.
  327.  
  328.        #Reg    (Optional,  added by  Install/Register option)  This line
  329.                holds the registration  information for registered users.
  330.                This line should not be manually edited.
  331.  
  332.        REBOOT  creates   the  CONFIG.SYS  by   reading  from  the   line
  333.        immediately  after  the  chosen  #Name  command (ignoring comment
  334.        lines  and blank  lines) up  to (but  not including)  the divider
  335.        line.  The AUTOEXEC.BAT is likewise  created by reading  from the
  336.        line immediately after  the divider to the next  #Name command or
  337.        the end of file (always ignoring blank lines and comments).
  338.  
  339.        The #Descr, #Flush and #Hist lines can be placed anywhere between
  340.        one #Name line and the next.
  341.  
  342.        All  modifications  to  the  configurations  should  be  made  to
  343.        REBOOT.CFG  (not  directly  to  the  AUTOEXEC.BAT  or  CONFIG.SYS
  344.        files). The  wrong flush command  may be used  if you change  the
  345.        type of disk cache in the CONFIG.SYS or AUTOEXEC.BAT directly. If
  346.        you  must  modify  or  create  a  new  CONFIG.SYS or AUTOEXEC.BAT
  347.        directly, be sure  to update the copy in  REBOOT.CFG, AND be sure
  348.        that the  special command lines  start with asterisks  (*) rather
  349.        than hashes (#) where necessary.
  350.  
  351.        REBOOT can optionally be forced  to write it's temporary files in
  352.        a directory pointed  to by the environment  variable TEMP. If you
  353.        have a slow  disk drive, you may wish  to set TEMP to point  to a
  354.        RAM Drive to  speed up the processing of  the REBOOT.CFG file. If
  355.        you have  a fast drive  or use a  large disk cache,  you may find
  356.        that pointing TEMP to the same drive that REBOOT.CFG is stored on
  357.        (or not setting it at all) will be faster.
  358.  
  359.  
  360.                        INSTALLING USER OPTIONS IN REBOOT
  361.  
  362.        Once  the REBOOT.CFG  file is  set up,  you may  install the user
  363.        options for REBOOT.  This can be done by  running REBOOT and then
  364.        pressing:
  365.  
  366.  
  367.  
  368.  
  369.        REBOOT v5.00 User Manual                                Page  -8-
  370.  
  371.  
  372.  
  373.                 Alt-I (or clicking on Install on the help line)
  374.  
  375.        This will  then show you  a screen offering  several sections you
  376.        may change.  The options available  include: setting the  colours
  377.        used  in  the  pick  list,  description  line, help line, warning
  378.        messages,   and  information   messages,  entering   registration
  379.        information, set  the disk that  the CONFIG.SYS and  AUTOEXEC.BAT
  380.        are to  be written to,  toggle mouse cursor  flashing on or  off,
  381.        toggle use of special reset code for  the DEC PCSA LAN on or off,
  382.        whether to default to a cold boot rather than a warm boot, and to
  383.        set  the  filename  of  the  editor  to  use  when  modifying the
  384.        configuration  file.   This  information  gets   written  to  the
  385.        REBOOT.CFG file.
  386.  
  387.        The editor filename entry can be entered in one of three ways. If
  388.        the editor can  be found via the DOS PATH,  only the file name of
  389.        the program is required (e.g. EDLIN). If the editor to use is not
  390.        in the  path, then the full  path, filename and extension  may be
  391.        entered (e.g.  C:\SYS\EDLIN.COM). Thirdly, you  may enter a  4DOS
  392.        alias. This  method requires the  command processor to  be loaded
  393.        (using up some  memory) and masks any errors  that have occurred.
  394.        Wherever possible  the most reliable  way of enabling  the editor
  395.        option is to  give the full path.  Most editors should be able to
  396.        load in the memory available,  an error message will be displayed
  397.        if there is insufficient memory to load.
  398.  
  399.        Colour  selections  selected  for  REBOOT  will  also be used for
  400.        ACTIVE.
  401.  
  402.        Pressing Escape  (or the right  mouse button) at  any time before
  403.        pressing Enter (or  the left mouse button) to  accept the setting
  404.        will  abort the configuration  without  making any  changes.  The
  405.        mouse is  fully functional throughout  the configuration program,
  406.        with the  left button being  the 'accept' key  (equivalent to the
  407.        'ENTER' key on the keyboard) and the right button the 'abort' key
  408.        (equivalent to the 'ESCAPE' key).
  409.  
  410.  
  411.                                 RUNNING REBOOT
  412.  
  413.        REBOOT can be run in two  ways:-
  414.  
  415.                REBOOT
  416.  
  417.        or      REBOOT Name
  418.  
  419.        If REBOOT  is typed without specifying  a name, a pick  list will
  420.        appear on screen of the configuration defined in REBOOT.CFG. If a
  421.  
  422.  
  423.  
  424.  
  425.        REBOOT v5.00 User Manual                                Page  -9-
  426.  
  427.  
  428.        name  is given,  the corresponding  configuration is  immediately
  429.        written and the computer rebooted.
  430.  
  431.        The   pick  list   allows  the   user  to   scroll  through   the
  432.        configuration  names  using  the  arrow  keys  (if  more  than 15
  433.        configurations exist, there is a  15 line window, and an elevator
  434.        bar will  appear).  If a  mouse driver is loaded, a configuration
  435.        can  be  chosen  by  pointing  to  the required configuration and
  436.        clicking the  left button once  to select, and  again to execute.
  437.        Alternately,   pressing  the   first  letter   of  the   required
  438.        configuration will move the cursor  bar to the next configuration
  439.        that  begins  with  this  letter.  When  the  highlight is on the
  440.        required configuration, pressing Enter  will start the write/boot
  441.        sequence. Pressing Escape, or the right mouse button, or the left
  442.        mouse button  while on the  Close Button (top  left of pick  list
  443.        border) any time before pressing Enter, or the left mouse button,
  444.        will  abort  without  writing  anything  and  without booting the
  445.        computer.
  446.  
  447.        While in the  pick list, four hot keys are  available to edit the
  448.        configurations (listed on the last line of the  screen).  Two hot
  449.        keys add new configurations to the end  of the list: Alt A (Add a
  450.        new configuration) and Alt C  (Copy the highlighted configuration
  451.        and modify).  Alt E allows you to Edit an existing configuration,
  452.        and Alt D allows deletion of an existing configuration.
  453.  
  454.        The REBOOT command  can also be followed by  any of the following
  455.        eight switches:
  456.  
  457.           /H and /?  (Help) both give a short  description of REBOOT and
  458.           the switches available.
  459.  
  460.           /N (No  boot) informs REBOOT to  write the configuration files
  461.           without  booting, allowing  you  to  boot with  this different
  462.           configuration at a later time. This option should be used with
  463.           caution, subsequent use of REBOOT will use this configurations
  464.           cache flushing  command and history updates,  which may not be
  465.           consistant with the active items.  See also /D.
  466.  
  467.           /C (Cold Boot) forces a  cold boot regardless of the installed
  468.           setting.
  469.  
  470.           /W (Warm Boot) forces a  warm boot regardless of the installed
  471.           setting.
  472.  
  473.           /R  (Return  to  Directory)  will  return  you to your current
  474.           directory after the configuration change. This is performed by
  475.           temporarily  appending three  lines: Drive  Name, CD Directory
  476.           Name, REBOOT /A XXXX (where  XXXX is the chosen configuration)
  477.  
  478.  
  479.  
  480.  
  481.        REBOOT v5.00 User Manual                                Page -10-
  482.  
  483.  
  484.           which  changes  to  the  appropriate  drive  and directory and
  485.           finally updates AUTOEXEC.BAT to remove these lines.
  486.  
  487.           /A (Autoexec only)  is a special command that  only writes the
  488.           AUTOEXEC.BAT file. The main use for this switch is by /R.
  489.  
  490.           /D (Down)  causes REBOOT to write  the selected configuration,
  491.           updating AUTOEXEC.BAT  and CONFIG.SYS (if  necessary), updates
  492.           the  History  file,  and  flushes  the  cache in readiness for
  493.           shutting off the computer (putting it down).
  494.  
  495.        Note: the cache is not flushed if the /N or /A switches are used.
  496.  
  497.  
  498.                               SEQUENCE OF EVENTS
  499.  
  500.        REBOOT  will perform  the following  sequence of  events once the
  501.        configuration has been selected and  the Enter key is pressed (or
  502.        if the configuration is given on the command line):
  503.  
  504.        REBOOT.CFG is scanned for the chosen configuration.
  505.        If  /A (Autoexec  Only) is  NOT  given  on the  command line  the
  506.        CONFIG.SYS  is written.
  507.        The AUTOEXEC.BAT is  written.
  508.        If /R is given on the command  line then three lines are added to
  509.        the  AUTOEXEC.BAT (Drive,  CD Current  Directory, REBOOT  /A XXXX
  510.        where  XXXX  is  the  chosen  configuration).
  511.        Active  markers are  updated in  REBOOT.CFG (*'s  replace #'s for
  512.        active config).
  513.        If /N (no  boot) is NOT given on the  command line, the following
  514.        are performed:
  515.           If  a #Hist  line is   found in  this configuration,  the 4DOS
  516.           history is  saved to the  file name listed  and duplicates are
  517.           removed.
  518.           If  a #Flush  line is  found in  this configuration,  the disk
  519.           cache is flushed using this command.
  520.           If /D (Down)  is NOT given on the  command line, the following
  521.           are performed:
  522.              If   DEC   PCSA   LAN   resetting   required   (enabled  in
  523.              installation), the LAN card is reset.
  524.              If  /W  is  given  on  the  command  line,  a  Warm boot is
  525.              performed, if /C is given on  the command line, a Cold boot
  526.              is performed, otherwise the PC  is booted using the default
  527.              booting method selected with the installation option.
  528.  
  529.  
  530.                               COMPANION PROGRAMS
  531.  
  532.        Three companion programs should be included in this package:
  533.  
  534.  
  535.  
  536.  
  537.        REBOOT v5.00 User Manual                                Page -11-
  538.  
  539.  
  540.        ACTIVE:
  541.  
  542.             This is a program that reports the active configuration, and
  543.             various system information. It shows the operating system in
  544.             use, and the configuration name as listed in REBOOT.CFG. Any
  545.             Any  description  line  included   in  REBOOT.CFG  for  this
  546.             configuration is displayed on the bottom line of the screen.
  547.             An errorlevel  is returned dependent  on the key  pressed to
  548.             exit the program.  The errorlevel returned is ascii value of
  549.             the uppercase of the key (Y = y = errorlevel 89).
  550.  
  551.        BTIME:
  552.  
  553.             This small program reads the  current time and date from DOS
  554.             and writes it  to the first line of REBOOT.CFG.  This should
  555.             only be run  from the AUTOEXEC.BAT file, as  its function is
  556.             to indicate  the approximate time and  date the computer was
  557.             last booted.  CHKBOOT should be called  before BTIME updates
  558.             the time  in REBOOT.CFG.  If the computer requires a program
  559.             to be run to set the DOS time, then BTIME should be run some
  560.             time after  the timer program.  Type "BTIME /?" (without the
  561.             quotes) for a short explanation of how to use BTIME.
  562.  
  563.        CHKBOOT:
  564.  
  565.             This  program compares  the  current  time and  date against
  566.             the time  and date set by  BTIME in the REBOOT.CFG  file and
  567.             returns  an errorlevel  dependent on  conditions supplied on
  568.             the command line.  CHKBOOT has five  switches to control the
  569.             comparison of time and date:
  570.  
  571.                /F        (default) returns an errorlevel  of 1 (true) if
  572.                          this  is  the  First  boot  of  the  day, or an
  573.                          errorlevel of 0 (false) if not. This switch may
  574.                          be omitted from the command line.
  575.  
  576.                /A:HH:MM  returns  true  if  the  current  time  is After
  577.                          (greater than  or equal to)  the time given  as
  578.                          HH:MM.
  579.  
  580.                /B:HH:MM  returns  true  if  the  current  time is Before
  581.                          (less than) the time given as HH:MM.
  582.  
  583.                /D:DDD    returns true  if the current  day is DDD  (i.e.
  584.                          Mon, Tue,  etc.), AND it  is the first  boot of
  585.                          the  day. Can  be used  for once  a week bootup
  586.                          procedures.
  587.  
  588.                /M:NN     returns true if the current day of the month is
  589.  
  590.  
  591.  
  592.  
  593.        REBOOT v5.00 User Manual                                Page -12-
  594.  
  595.  
  596.                          NN (i.e. 1  for the first of the  month, 30 for
  597.                          the  30th of  the month,  etc.), AND  it is the
  598.                          first boot of  the day.  Can be used for once a
  599.                          month bootup procedures.
  600.  
  601.             If  an  error  occurs,  then  an  errorlevel  of 255 will be
  602.             returned. See the example  REBOOT.CFG's for typical usage of
  603.             BTIME and CHKBOOT.  Type "CHKBOOT  /?" (without the  quotes)
  604.             for a short explanation of how to use CHKBOOT.
  605.  
  606.  
  607.                                TROUBLE-SHOOTING
  608.  
  609.        REBOOT.CFG corruption:
  610.  
  611.        If you  are having trouble with  REBOOT corrupting its REBOOT.CFG
  612.        file,  there is  a good  chance you  are using  a disk cache that
  613.        delays writing to the disk. If so, there MUST be a #FLUSH command
  614.        in the REBOOT.CFG  file that will flush or disable the cache.  If
  615.        you are using  a delayed write disk cache, and  you have a #FLUSH
  616.        line, check that the cache program  is either in the PATH, or the
  617.        full filename  and path of the  cache flush command is  given (an
  618.        error should  be displayed if the  file cannot be found,  but may
  619.        flash  by so  quickly that  it is  not noticed).  See the example
  620.        #FLUSH commands in the example configurations.
  621.  
  622.        Erratic Mouse Flashing:
  623.  
  624.        Some mouse drivers  are unable to react fast  enough to flash the
  625.        mouse cursor  on and off while  still being active.  The Logitech
  626.        mouse driver version 5.01 is known  to cause some trouble in this
  627.        regard.  Turn the mouse flashing option off if problems do occur,
  628.        then exit from REBOOT and restart.
  629.  
  630.        Insufficent memory for editor:
  631.  
  632.        REBOOT remains resident in memory  while the editor is called. If
  633.        this  error occurs,  remove as  many memory  resident programs as
  634.        possible  to  free  up  sufficient  memory  for  REBOOT  and your
  635.        favourite editor.
  636.  
  637.        Error - unable to load editor:
  638.  
  639.        This error  message is not  the same as  the last.  If this error
  640.        occurs, it is probably because  the editor has not been correctly
  641.        specified in the installation.  Where possible, the full path and
  642.        file name should be supplied for REBOOT to find the editor.
  643.  
  644.  
  645.  
  646.  
  647.        REBOOT v5.00 User Manual                                Page -13-
  648.  
  649.  
  650.        Error - unable to create temporary file:
  651.  
  652.        If this error message occurs, it may mean one of two things.  The
  653.        most likely is that there  is a TEMP environment variable defined
  654.        that is not pointing to a valid directory.  The other possibility
  655.        is  that there  was a  write error  (hardware) when attempting to
  656.        create the  file.  The solution  to the most  common reason is to
  657.        either   SET   the   TEMP   environment   variable   to  a  valid
  658.        drive/directory, or remove the TEMP environment variable entirely
  659.        (SET TEMP=).
  660.  
  661.        Error - unable to create REBOOT.TMP:
  662.  
  663.        REBOOT attempts  to create a file  called REBOOT.TMP (a temporary
  664.        file that is merged back into REBOOT.CFG when you finish editing)
  665.        whenever you  call the editor  from within REBOOT.  If this error
  666.        occurs, check to see that there  is not another file of this name
  667.        in the directory pointed to  by the TEMP environment variable, or
  668.        if  no  TEMP  environment  variable  exists,  the  directory that
  669.        REBOOT.CFG resides in.
  670.  
  671.        Error - unable to open REBOOT.CFG:
  672.  
  673.        This error message  may occur if the REBOOT.CFG file  is not in a
  674.        directory specified by the DOS PATH.  Another possibility is that
  675.        the REBOOT.CFG  file has been  marked Read Only.  REBOOT requires
  676.        read/write  access  to  the  REBOOT.CFG,  remove  the  Read  Only
  677.        attribute.
  678.  
  679.        Error - null #Name encountered:
  680.  
  681.        This may occur if you manually edit the REBOOT.CFG file and enter
  682.        a #Name = line  without actually specifying a name.  The #Name is
  683.        required for each configuration, and each must be unique. At this
  684.        point in time, REBOOT will not detect duplicate names and display
  685.        both in the  pick list, though only the  first configuration will
  686.        be written if either of the configurations is chosen.
  687.  
  688.        REBOOT may report other error  messages, though those not covered
  689.        here  should  not  occur  unless  some  sort  of hardware related
  690.        problem occurs (bad sectors on the hard disk, etc.).  If an error
  691.        occurs that is not covered  here that is not immediately obvious,
  692.        and you  do not believe  should have occurred,  please send me  a
  693.        copy of  your REBOOT.CFG file,  along with a  note explaining the
  694.        conditions  under  which  the  error  can  be  duplicated, to the
  695.        address noted above or via Fidonet Netmail to 3:690/643.5.
  696.  
  697.  
  698.  
  699.  
  700.        REBOOT v5.00 User Manual                                Page -14-
  701.  
  702.  
  703.                                 PROGRAM HISTORY
  704.  
  705.        v1.61 : First  public  release  (Public  Domain).  Keyboard  only
  706.                operation.
  707.  
  708.        v2.00 : Full mouse and  keyboard  user interface (scrollable menu
  709.                list  with   "elevator  bar").  Windowed,   mouse  driven
  710.                configuration.  Larger 4DOS  history file  can be handled
  711.                (4096 bytes maximum with no more than 2048 lines).  Fixed
  712.                Bug where History was written even when disabled.
  713.  
  714.        v2.11 : Changed  handling  of  Disk  Cache  Flushing.  The  flush
  715.                command is  no longer stored within  the EXE file (allows
  716.                program  to be  compressed  with  LZEXE or  similar after
  717.                configuration).  Companion program ACTIVE.EXE included to
  718.                give easy identification of current configuration.
  719.  
  720.        v2.12 : Bug   fix  for   cache  flush   being  indeterminate  for
  721.                configurations without a #Flush line.
  722.  
  723.        v2.13 : Bug  fix for  #Names  longer  than 20  characters causing
  724.                active  markers to  be removed.  Fix for  ACTIVE crashing
  725.                when no description.
  726.  
  727.        v2.14 : Bug fix for command line  entry of configuration name not
  728.                flushing cache.
  729.  
  730.        v2.16 : Network  compatibility  increased.  Bug  fix  for  ACTIVE
  731.                returning incorrect 4DOS version.
  732.  
  733.        v3.00 : Major rewrite  of all programs.  Optimised for speed  and
  734.                size, added DOWN.EXE (replaces DOWN.BTM). Changed version
  735.                numbers  of  companion  programs  to  same  as REBOOT for
  736.                consistency.
  737.  
  738.        v3.01 : Multiple  History files  allowed -  #Hist command  added.
  739.                Distributed as Shareware from this version on.  Fixed Bug
  740.                concerning Logitech Mice.
  741.  
  742.        v3.02 : Cold boot/Warm boot override command line switches added.
  743.                NOTE: COMMAND LINE SWITCHES CHANGED; /C now causes a Cold
  744.                boot  override,  /I  (Install)  replaces  the previous /C
  745.                (Configure).  Four new  utility programs  added: BTIME  &
  746.                CHKBOOT  (conditional  booting  utilities),  TIMEBOOT and
  747.                TIMEDASK.  Bug  fix  for  MS-DOS  4.xx  large partitions.
  748.                Rewritten DOWN  to include multiple  history files (which
  749.                was missed in the 3.01 release). Option included to reset
  750.                DEC  PCSA  LAN  cards  (not  tested).  ACTIVE modified to
  751.                include boot  time and current time.  COMPACT, REBOOT and
  752.  
  753.  
  754.  
  755.  
  756.        REBOOT v5.00 User Manual                                Page -15-
  757.  
  758.  
  759.                DOWN  modified to  ignore case  when removing  duplicates
  760.                from history files.
  761.  
  762.        v3.03 : Bug  fix  for  monochrome  screens  losing  entries  from
  763.                display.  Was supposed to have been fixed in last version
  764.                but was unfortunately left out.
  765.  
  766.        v4.00 : Major rewrite  of file input  and output routines  in all
  767.                programs  (Speed  has   improved  markedly).  Editing  of
  768.                configurations  now  available  (using  your own editor).
  769.                COMPACT  handles  files  twice  as  large  as previously.
  770.                Compacting  algorithm reworked,  now more  than twice  as
  771.                fast.  Error handling improved,  fixed lock up with  some
  772.                user errors.
  773.  
  774.        v4.01 : REGISTRATION CHANGED: once only  payment for this version
  775.                and  ALL  subsequent  versions  (users already registered
  776.                need pay no extra money).  BRAND program no longer needed
  777.                to register program  (registration function now available
  778.                from install).  All defaults and registration information
  779.                is  now  stored  in  config  file,  allowing  EXE's to be
  780.                compressed with LZEXE/PKLITE  etc. (also means subsequent
  781.                versions will be already setup with your colour selection
  782.                and registration). Bug fix for configuration files larger
  783.                than 8K  having problems updating # and *.  Alias allowed
  784.                for calling  editor.  Mouse selection of options on  help
  785.                line now available.  Option to turn flashing mouse cursor
  786.                on  or off  (now defaults  to off,  as some mouse drivers
  787.                have  problems  with  flashing  mouse  cursor).  TIMEBOOT
  788.                modified to allow for use during midnight rollover.
  789.  
  790.        v4.02 : /R and  /A switches added, /I switch removed.  /R Returns
  791.                you to your current directory  after rebooting with a new
  792.                configuration. /A writes the AUTOEXEC.BAT file only (used
  793.                by /R switch). The first 40 characters of the #Descr line
  794.                are   now   written   to   a   4DOS   DESCRIPT.ION  file.
  795.                Optimisations made  to all utilities.  Due to the size of
  796.                the  ZIP  file  being   rather  large  for  international
  797.                distribution,   some   of    the   utilities   previously
  798.                distributed with this  package now distributed separately
  799.                (COMPACT,  TIMEBOOT,  TIMEDASK,  SQZ.BTM)  in  a 4DOS/DOS
  800.                BATCH Utility  Archive.  Look for 4DDBU402.XXX (where XXX
  801.                is  ZIP,  LZH  etc.).  These  are  the  files that do not
  802.                require  REBOOT.CFG to  be present  to work.  Bug fix for
  803.                registration  option  creating  multiple  copies  of #Reg
  804.                line.  /R switch added to DOWN program. As for REBOOT, /R
  805.                returns you to your current directory at next boot-up.
  806.  
  807.  
  808.  
  809.  
  810.        REBOOT v5.00 User Manual                                Page -16-
  811.  
  812.  
  813.        v5.00 : Complete  replacement  of  all  low  level  routines with
  814.                highly  optimised  assembler   routines.  User  interface
  815.                reworked,    modernised.   Mouse    routines   completely
  816.                rewritten,  allowing auto  repeat on  holding down  mouse
  817.                button.  Desqview compatibility  added.  /D (Down) switch
  818.                added, allows choice of  configuration for next power up.
  819.                DOWN program removed (replaced by DOWN.BAT).  This switch
  820.                was added  to fix problems people  were having with using
  821.                REBOOT /n to set the  configuration to use at next switch
  822.                on, then  using DOWN before  switch off.  This caused the
  823.                wrong history files to be updated, and possibly the wrong
  824.                cache flush  command to be used.  The asterisk (*) symbol
  825.                is   now   available   as   a   synonym   to  the  active
  826.                configuration.  An example of the use  of this feature is
  827.                as a replacement for the DOWN program:
  828.  
  829.                         REBOOT * /D
  830.  
  831.                This will cause REBOOT to  flush the cache and update the
  832.                history   file  but   not  write   the  AUTOEXEC.BAT   or
  833.                CONFIG.SYS.  Bug  fix  for  first  letter  searching  not
  834.                working.  Bug  fix  for  very  occassional '#' characters
  835.                ending up in the wrong place for config files larger than
  836.                8K.  Bug fix for DESCRIPT.ION file  being written even if
  837.                one did not exist before.  ALL temporary files written to
  838.                directory pointed  to by TEMP environment  variable if it
  839.                exists.  New configurations are now  checked for validity
  840.                before creation. Ability to create REBOOT.CFG (if it does
  841.                not exist) from within REBOOT.  ACTIVE improved, with DOS
  842.                5.0 loaded, will  inform whether DOS is loaded  in HMA or
  843.                ROM.
  844.  
  845.  
  846.                                  ABOUT REBOOT
  847.  
  848.        For those that are interested, the REBOOT suite was written using
  849.        Turbo Pascal  6.0 (no matter what  anyone else says, this  is the
  850.        best version yet!) and Turbo  Assembler 2.0, with assistance from
  851.        Turbo  Debugger  and  Turbo  Profiler.  The  unit  libraries were
  852.        written by Glenn Crouch and Peter Ogden. The author would like to
  853.        thank Glenn  Crouch and Jason Cowie  (beta tester extraordinaire)
  854.        for their  patience and thoroughness  in beta testing  REBOOT and
  855.        its associated programs.
  856.  
  857.  
  858.  
  859.  
  860.        REBOOT v5.00 User Manual                                Page -17-
  861.  
  862.  
  863.                                ACKNOWLEDGEMENTS
  864.  
  865.        4DOS is copyright Rex Conn & J.P. Software.
  866.        MS-DOS is copyright Microsoft.
  867.        PC-DOS is copyright IBM.
  868.        PC-Cache is copyright Central Point Software Inc.
  869.        Hyperdisk is copyright Roger Cross.
  870.        QEMM and Desqview are copyright Quarterdeck Office Systems.
  871.        DEC and DEC PCSA are trademarks of Digital Equipment Corporation.
  872.        LZEXE is copyright Fabrice Bellard.
  873.        PKLite is copyright PKWare.
  874.        Turbo Pascal, Turbo Assembler,  Turbo Debugger and Turbo Profiler
  875.        are copyright Borland International.
  876.  
  877.                                    ---***---
  878.  
  879.